home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / os2 / humaneko.zip / HUMANEKO.TXT < prev    next >
Text File  |  1994-01-01  |  12KB  |  241 lines
  1. ===============================================================================
  2. -------------------------------------------------------------------------------
  3.                
  4.                HumaNeko - An OS/2 Neko Program With a Human Touch
  5.        Written By Eric A. Wolf - Copyright (C) 1994 - All Rights Reserved
  6.  
  7. This program is SHAREWARE!  Please read the registration information at the end
  8.      of this document for details on how to register your copy of HumaNeko.
  9.  
  10. -------------------------------------------------------------------------------
  11. ===============================================================================
  12.  
  13.  
  14.  
  15. == Introduction ============
  16.  
  17. If you are familiar with "Neko the Cat" or the "Cat and Mouse" program that 
  18. comes bundled with OS/2, then you are already familiar with HumaNeko 
  19. (pronounced "Human Neko").  In short, HumaNeko is Neko (or Cat and Mouse) with 
  20. a human-touch.  Instead of having a little animated cat chase your mouse cursor 
  21. around, in HumaNeko, a little human is trapped inside a window and playfully 
  22. follows your mouse pointer.
  23.  
  24. HumaNeko will faithfully follow your mouse cursor wherever it goes on the
  25. screen.  However, if you move it outside HumaNeko's window, HumaNeko will try
  26. and get your attention so that you move the pointer back into the window and he
  27. can play some more.  Also, if your mouse cursor is inside the window, and
  28. you don't move it for a while, HumaNeko will get tired of standing around and 
  29. he'll occupy himself doing other things.  Once he's busy doing other things,
  30. you can try and slowly move the mouse away from him.  But do it slowly!  If
  31. he catches you, he'll jump and get back to chasing you around!
  32.  
  33. HumaNeko is playful and comes with one additional feature.  Called Run-Away,
  34. if you select this, you and your little human friend engage in a game of Tag,
  35. and you're "it"!  You have to use your mouse and click on HumaNeko as he
  36. runs around the screen taunting you!
  37.  
  38. -------------------------------------------------------------------------------
  39.  
  40. == Installation ============
  41.  
  42. Installing HumaNeko is easy.  Simply put HUMANEKO.EXE somewhere on your hard
  43. drive and go to the OS/2 desktop.  Go to your templates folder and drag out
  44. a program template.  When the notebook appears, fill in the application name
  45. (making sure to include the path where you put HUMANEKO.EXE).
  46.  
  47. For example, if I put HumaNeko on my hard drive (C:) and under my OS/2
  48. directory, in a directory called HumaNeko, I would put 
  49. C:\OS2\HUMANEKO\HUMANEKO.EXE in the program portion of the settings
  50. notebook.  Close this settings notebook and you can start HumaNeko at any
  51. time by double clicking on the HumaNeko icon.
  52.  
  53. You may also start HumaNeko from the OS/2 command line.  Simply go to the
  54. directory which holds HumaNeko and type:  HUMANEKO <press enter>.
  55.  
  56. Further instructions for making an icon for an existing .EXE file or starting
  57. an OS/2 application can be found in the OS/2 2.x documentation.
  58.  
  59. If you make a program object for the file (by dragging a program template out
  60. of the templates folder), feel free to assign it any icon you wish.  We have
  61. provided a sample HumaNeko icon (found in the directory you uncompressed
  62. HumaNeko) for your convenience.
  63.  
  64. -------------------------------------------------------------------------------
  65.  
  66. == Using HumaNeko ==============
  67.  
  68. Once HumaNeko is started, you will see your little human follow your mouse
  69. cursor around.  He will follow you around whever you go.  The program's use
  70. is self-explanatory but, just for completeness, a few details about the 
  71. program's operation follow:
  72.     
  73.     PLAY-MODE
  74.     ---------
  75.         CHASE MODE:  When you first start HumaNeko, this is the mode of
  76.                      operation HumaNeko is in.  In this mode, the human will
  77.                      faithfully follow your mouse pointer wherever it goes.
  78.                      If the mouse pointer is inside HumaNeko's window and you
  79.                      don't move the mouse for awhile, HumaNeko will get bored
  80.                      and occupy himself doing other things.  Once he is busy
  81.                      entertaining himself, you can try and slowly move the
  82.                      mouse away from him.  But do it very slowly so that he
  83.                      doesn't notice!  Moving your mouse outside of HumaNeko's
  84.                      window only frustrates the poor guy!
  85.  
  86.         RUN-AWAY MODE:  Once you select this mode from the Options menu item,
  87.                         HumaNeko tries to run away from you.  He'll dart in
  88.                         every direction dodging you.  In fact, if you don't
  89.                         catch him fast enough, he will even taunt you!  You
  90.                         catch him by clicking your first mouse button with
  91.                         the pointer directly on top of him.
  92.                         
  93.                         To disengage this mode of operation, select Chase Mode
  94.                         from the Options menu to put HumaNeko back to his
  95.                         cursor-chasing self.
  96.  
  97.     OPTIONS:  Selecting this will bring up a dialog box with different    
  98.               settings you can change about HumaNeko.  Each is changed by
  99.               dragging the slider left and right in each control.  A
  100.               description of each follow:
  101.  
  102.               Update Frequency:  This indicates how often HumaNeko moves.
  103.                                  He can either move very often (quickly) or
  104.                                  not very often (thus, very slowly).
  105.     
  106.               Step Rate:  This indicates how far HumaNeko can move with each
  107.                           step.  HumaNeko can either take very large steps
  108.                           (and move very fast) or take baby steps and move
  109.                           very slowly.
  110.  
  111.               Mouse Sensitivity:  When HumaNeko is occupying himself, you can
  112.                                   try and be sneaky and slowly move the mouse
  113.                                   away from HumaNeko without his noticing.
  114.                                   This control decides how sensitive HumaNeko
  115.                                   is to your movement once he is busy.
  116.     
  117.     EXIT:  This function ends the HumaNeko program
  118.  
  119.     GENERAL HELP:  This brings up a very basic dialog box describing the
  120.                    features and options in humaNeko
  121.  
  122.     PRODUCT INFORMATION:  This brings up a dialog with information on the
  123.                           version number of the software, author information,
  124.                           copyright information, etc.
  125.  
  126.  
  127. -------------------------------------------------------------------------------
  128.  
  129. == Registration ============
  130.  
  131. If you like HumaNeko, or perhaps, you enjoy having the complete source code
  132. for an OS/2 PM program to aid you in writing your own programs, I ask you to
  133. register your copy of the program.  The registration cost is only $10.00 and
  134. it will only be with your support that I continue to develop for OS/2, 
  135. and especially, provide the complete source code for any of my works.
  136.  
  137. You can register your copy of HumaNeko with me for only $10.00.  Please send 
  138. your registration payment as a check or money order (US funds only) to:
  139.  
  140.                         Eric A. Wolf
  141.                         498 Wiley Hall NW
  142.                         West Lafayette, Indiana  47906-4223
  143.  
  144.  
  145. After 4/30/94, please send your registration payment to:
  146.  
  147.                         Eric A. Wolf
  148.                         1630 North Johnson Street
  149.                         South Bend, Indiana  46628-2936
  150.  
  151. I want to encourage everyone to start writing applications for OS/2, no
  152. matter how simple or complex.  That is why I am providing the source code 
  153. with this program.  If you've never developed for OS/2 before, now is your
  154. time to start and you have this to look off of to get you going.
  155.  
  156. Please note, however, I provide the source code as-is and as a learning tool 
  157. for aspiring programmers.  Please do NOT modify the source code and re-release 
  158. an exact or similar product.  The source is provided solely as a learning 
  159. device.  The $10.00 registration fee is cheaper than any OS/2 programming 
  160. book and what I provide is a complete, functional OS/2 PM application and 
  161. ALL component source files that comprise it (how many books do that?)
  162.  
  163. If the response is good enough, and only if the response is good, I will 
  164. continue to develop products and ship the source code along with them.  It
  165. benefits us all with this type of distribution, please do your part to
  166. support it!!
  167.  
  168. I will answer no questions about the source code of the program from an
  169. individual until a registration payment has been received.  Once registered,
  170. source questions can be directed to me via electronic mail only:
  171.                 
  172.                 CompuServe:   71575,1515
  173.                 Delphi:       OLDGROUCH
  174.                 internet:     ericwolf@mentor.cc.purdue.edu
  175.  
  176. If you have general comments or questions about the program, you may also
  177. send them to any of the electronic addresses above.  Thanks!
  178.  
  179. -------------------------------------------------------------------------------
  180.  
  181. == Source Code ===========
  182.  
  183. This program comes complete with the entire source code that generated it.
  184. Please note the following restriction:
  185.  
  186.    HumaNeko's source code is to be modified by the author alone.  The source
  187.    code is provided as a learning tool ONLY!  No modifications may be made
  188.    to it to reproduce a same or similar product.  The copyright remains that
  189.    of solely the author and the program is protected under both United States 
  190.    and International Copyright Laws.
  191.  
  192. The complete source code for this program can be found in the SOURCE
  193. directory that was created when you uncompressed this program.  It was
  194. developed on Borland's C++ for OS/2.  A project file (HUMANEKO.PRJ) has been
  195. provided to facilitate your working with these files.  Each source file
  196. is documented and you should review the code with some good OS/2 references
  197. in hand (PM references, etc.)  Borland's online help system is great start!
  198.  
  199. In the SOURCE/BITMAP directory are all the bitmaps used in the animation
  200. sequences in this project.  The icon is a standard 32x32 16 color icon while
  201. the bitmaps are all 48x48 16 color bitmaps.
  202.  
  203. -------------------------------------------------------------------------------
  204.  
  205. == Distribution of HumaNeko ========================
  206.  
  207. You are free to distribute HumaNeko to whomever and however you wish as long
  208. as the following conditions are upheld:
  209.  
  210.   -  HumaNeko should always be distributed in its entirety.  This includes
  211.      all documentation, executables, and source files.  Under no circumstances
  212.      should HumaNeko be distributed without ALL of its original files.
  213.      Distribution of HumaNeko is strongly encouraged, this includes distribution
  214.      by individuals, BBSes, electronic servies, shareware houses, cd-rom 
  215.      pressers, etc.  All I ask is that those who use HumaNeko pay their $10
  216.      registration fee.
  217.  
  218.   -  HumaNeko's source code is to be modified by the author alone.  The source
  219.      code is provided as a learning tool ONLY!  No modifications may be made
  220.      to it to reproduce a same or similar product.  The copyright remains that
  221.      of solely the author and the program is protected under both United States 
  222.      and International Copyright Laws.
  223.  
  224.   -  If you use HumaNeko, you MUST register it (directions for doing so
  225.      preceeded this section of the text).  "Use" includes both the actual
  226.      use of (or playing with) the HumaNeko program -or- using the source code 
  227.      as a reference for your own works.  If you use the source as a reference, 
  228.      please register your copy ($10.00 is cheaper than any book you can buy on
  229.      OS/2 programming and what is going to teach you as much??)  
  230.      
  231.   -  Remember, if you like the program (even if you don't care much for the 
  232.      source code) you should still register!!
  233.  
  234.  
  235.  
  236.    -------------------------------------------------------------------------
  237.    Remember if you like HumaNeko and use it or if you use or plan to use the
  238.      source code as a reference for your own works, please register today!
  239.    -------------------------------------------------------------------------
  240.  
  241.